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Preface 



This manual describes problems that can arise during normal use of the SunOS 
operating system and a number of its utility programs. We suggest that you read 
SunOS User’s Guide: Getting Started before using this manual. 

NOTE This manual does not cover procedures for system maintenance, malfunctions, or 

troubleshooting. For information about those topics, refer to System and Net- 
work Administration. 

Chapter 1 is an introduction. It includes a list of important problems, and steps to 
prevent or work around them. 

Chapter 2 describes problems logging in and out. 

Chapter 3 describes error messages that can happen when running commands and 
what they mean. 

Chapter 4 describes error messages for selected commands. 

Chapter 5 describes problems and error messages that can occur when editing 
text files. 

Appendix A describes error messages that can occur when using remote systems 
over the network. 




- IX - 





Introduction 



When you begin using any new piece of equipment, problems can arise that seem 
to require prior experience to avoid or correct. Remember your first few 
encounters with a sewing machine or with car repairs? 

A bit of guidance can be most helpful when you know what you are trying to 
accomplish, but have hit a snag. This manual is intended to provide you with 
pointers to get through the sorts of problems that many beginners find perplex- 
ing. The majority of problems most users face stem from simply not knowing 
what to do in a given situation. 

This chapter describes initial steps for dealing with any problem, lists some of 
the most serious ones you may encounter, and describes what you can do about 
them. Subsequent chapters deal with problems that may come up when perform- 
ing activities, such as logging in and out, running commands or editing files. 



1.1. Discovering a Problem There is never a convenient time to discover that you have a problem. As a 

beginning user, a problem typically comes to your attention when the system 
displays a message such as: 

File not found. 

Command not found. 

or 

Permission denied 



Messages like this can be both perplexing and disturbing, but there is a reason 
behind each one. Often, the reason becomes obvious as soon as you think about 
it, but sometimes it takes a bit of detective work to figure out. 



Since detective work can be difficult 
when you don’t know where to look, 
it may help to befriend an experi- 
enced user who can diagnose prob- 
lems that are especially puzzling. 



Whenever a problem occurs, there are some steps that you can take to minimize 
the interruption and prevent any further complications from arising. 

When you are confronted with an error message, stop what you are doing for a 
moment. Make note of what you are trying to accomplish and how far along you 
were when the problem came up. Then note the command that resulted in the 
error message (in most cases the command that you just typed in). 
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This will come in handy if you have to ask your system administrator 1 or a more 
experienced user for help. This will also make it easier for you to pick up from 
where you left off should you need to play detective. 

The vast majority of error messages come as the result of mistyping a command 
or filename. So check the command line for spelling errors and typos. 

Another common problem, even among experienced users, is being in the wrong 
directory when you type in a command. Check to see what directory you are in 
with pwd. 

If you have occasion to use another person’s account, you may have forgotten 
which one you are currently using. When you are logged in as someone else, 
files that belong to your account may not be accessible. Check to see which 
account you are using with who ami. 

If the steps so far haven’t revealed the source of the problem, then you are going 
to have to do some digging. So, along with your note about what you were doing 
when the problem occurred, copy down the error message exactly as it appears. 
This information will be important to you as you look for answers in this manual, 
and vital to anyone trying to help you. 

By following these steps, you will have gathered enough information to answer 
the important questions of: 

What? What, exactly, was the error message? 

When? At which stage in your work did the problem arise, and with which 
command? 

Where? What directory were you in? 

Who? Whose account were you using? 

This makes the questions of “Why did the problem arise?,” and “How can I 
correct it?” much simpler to track down, especially when you need to get expert 
help. 



1 If your workstation is equipped with its own disk drive, then you may be able to perform tasks that we 
indicate should be referred to the system administrator. These tasks are described in System and Network 
Administration. 
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Step 1: Stop. Make a note of what you are trying to accomplish and how far 

along you are. Make note of the specific command that resulted in 
the error message. 

Step 2: Check the command line for typing errors. 

Step 3: Check to see what directory you are in with pwd. 

Step 4: Check to see which account you are using with who ami. 

Step 5: Take down the error message exactly as it appears. Check this 

manual for answers, and if necessary, get help from your system 
administrator or an experienced user. 

^ ' 



1.2. Worst Cases One problem that almost all beginners seem to face is anxiety about making a 

disastrous mistake. The fear that one may accidentally destroy valuable files or 
bring the system crashing down is as unnerving as it is exaggerated. (It takes 
more knowledge than most beginners have to do any serious harm). But it’s only 
natural to be apprehensive when you aren’t sure of the risks involved. 

Perhaps the best way to overcome this anxiety is to learn what the realistic risks 
are and what you can do to minimize them. 

It is possible to remove or erase the contents of a file unintentionally, but there 
are simple steps that you can take to help prevent this from happening. (It is also 
possible to make the system crash — say, by unplugging your keyboard and then 
plugging it back in — but it is normally quite easy to start it back up again.) 

Deleted Data or Files Perhaps the worst problem that you will encounter as a beginner is the accidental 

deletion of a file or a portion of its contents. Once removed, a file is gone for 
good, and the same is true for any contents that you erase. 

Your system administrator should be making regular backup tapes of all files that 
change and can usually recover a recent copy of the file containing all but the 
current day’s work. Still, losing a full day’s work on an important file can be a 
big disappointment. 

You can take the following steps to prevent your files from being accidentally 
deleted or overwritten. One thing you can do to help skirt the problem of lost or 
“trashed” files is to make a copy of the file from time to time — say, after every 
major change. This “shadow version” of your file will serve as a startup point if 
you should lose the original. 

We assume that you are using the If the following lines are not already contained in your . cshrc file, cd to your 

c shel1 - home directory and insert them: 2 



It is a good idea to check with your 
system administrator about the 
backup schedule for your system. 



2 Refer to SunOS User’s Guide: Customizing Your Environment for more information about your .cshrc 
file. 
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Figure 1-1 



Be sure to open any shell-tool 
or cmdtool windows that are 
iconic and run this command in 
them as well. 



Safety Lines for Your . c shr c File 



r 

set noclobber 








alias cp 


' cp 


-i' 




alias rm 


' rm 


-i' 




alias mv 
c 


' mv 


-i' 


j 



The set noclobber command prevents existing files from being overwritten 
when you use the > symbol to redirect output. The alias commands indicate 
that cp, rm, and mv are to run with the -i option — to ask you for confirmation 
before removing or overwriting existing files. 

To make sure that these commands take effect immediately, type 

source .cshrc 

on your terminal, or in each cmdtool or shelltool window currently run- 
ning. 





Step 1 : Insert the lines 



set noclobber 






alias cp 


' cp 


-i 


alias rm 


' rm 


-i 


alias mv 


' mv 


-i 


in your . cshrc file. 







Step 2: Run the command source . cshrc in every shelltool or 

cmdtool window, or on your terminal. 

v , 



System Shutdown If your system administrator should need to take the system down while you are 

using it, you may see a broadcast message telling you that the system is about to 
shut down. Whenever the the system shuts down, it automatically saves files that 
you are editing with vi. 3 Even so, it is a good idea to type (Esc) : wq as soon as 
you see the broadcast message. 

If you are running other programs and want to make sure that the most recent 
data is saved, type in the sync command: 



f — ■ : ■ — . . '■ \ 

venus % 

Broadcast Message from venus ! root (console) at 12:44 

System Going Down Immediately! 

sync 

venus % 

V ■ > 



3 also ex and ed. 
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To recover the file you were editing after the system has come back up, cd to the 
directory you were in at the time of the crash, and type in the command: 

vi -r filename 

Then, before you do anything else, type in the command: 

: w 



This assures you that the recovered version is properly written out. 



r 


>1 


System Shutting Down: 




Write and quit from vi when you see the broadcast message, or use 
the sync command to force data to be saved. 


System Comes Back Up: 


Step 1: 


cd to each directory containing files you were editing 
and: 


Step 2: 


Use vi -r to recover preserved files. 


Step 3: 


vi displays the date the file was preserved on its mes- 
sage line, after checking this date, type in the command 
: w to assure that the preserved version is saved. 


v 


J 



System Crash If the system crashes, or shuts down unexpectedly, files that you are editing are 

preserved as indicated above. Should this happen while you are using the works- 
tation itself, the windows and mouse will cease to function and messages such as 
those shown below will appear at the lower left of the workstation screen. If you 
are logged in on a terminal, things will simply come to a halt. 

If you are logged in at a terminal Abort at 004832 

when the system crashes, contact 

your system administrator for assis- or 

tance. 

panic: condition 

If the message says panic this doesn’t mean that that you should. It means that 
the system’s internal software encountered some sort of rare and unusual error 
condition. The condition often clears up when you start the system back up. 
Even so, it is a good idea to take down the entire message for your system 
administrator’s information before proceeding to restart the system. Even when 
the system comes back up successfully, it is best to report any panic messages 
to your system administrator. 

The message is followed by a right angle-bracket (>). This is the monitor 
prompt. To restart (or reboot ) the workstation, type in the monitor command b 
when you see this prompt: 





> 


> b 




l 


V 




sun 

microsystems 
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Unresponsive Terminal 



The system will display a series of messages and eventually ask you to log in. 4 
. 

Step 1 : If the word panic appears in the error message, take down what the 

message said. 

Step 2: When the monitor prompt appears, type in b to restart the system. 

Step 3: If the system hasn’t prompted for login in 15 minutes or so, contact 

your system sdministrator for help. 

Step 4: Perform the steps in the previous section under System Comes Back 

Up 

v * 



When the terminal (or cmdtool orshelltool window) gets confused or 
hung, there is often no error message. Instead, the terminal may not display 
things properly. It may display only its prompts and messages but not what you 
type, or it may display only what you type and nothing else. This sometimes 
happens when you interrupt an interactive game with ( Ctrl-C 1 . 

To clear the terminal or window, use the reset command as follows: 



— — \ 

venus % 1 Line Feed 1 
venus % reset 
venus % f Line Feed 1 



Even if the terminal doesn’t display anything, it often recognizes this command, 
and clears up. Use ( Line Feed 1 rather than I Return 1 . because when it is confused, 
the terminal may not recognize I Return 1 properly. 

(It’s a good idea to be a bit patient with your machine, too. Many times a termi- 
nal appears to be hung, when in fact it’s just slowed down due to heavy demands 
on it. This is especially likely if you are running several processes at once or if 
the network experiences particularly heavy usage.) 

Error messages are often displayed when you type the first I Line Feed 1 . and the 
system finally looks at everything you have typed since the last successful com- 
mand. 

If this doesn’t clear things up and the problem is with a cmdtool or 
shelltool window, you may have to quit the window and open a new one. If 
the problem is with a terminal, you may have to get help from your system 
administrator. If you are logged in on a remote terminal over the phone lines, 
you may have to log out and dial in again. If you’re on a single-user workstation, 
reboot it. 



4 Sometimes the system has to verify its data when it comes up again, and this can take up to 15 minutes. If 
you don’t get a login prompt by then, contact your system administrator for assistance. 
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Problems With Logging In, Logging 

Out, and Passwords 



In order to log in to the system, you must have an account set up for you by your 
system administrator. If this hasn’t been done yet, or if a mistake is made when 
setting up an account, you may not be able to log in. Problems with logging out 
can come up when you have stopped jobs or when you attempt to log out from 
within a different shell (such as a shelltool window) than the one you logged 
in on. 

2.1. Can’t Log In There is generally little that you can do about not being able to log in except to 

contact your system administrator and wait for her or him to correct the problem. 

Account Not Set Up If you have no account on a system, you cannot log in to it. If your system is 

connected to a network that uses the NIS, however, once your account is set up, it 
may be recognized by other machines on the network as well as your own. See 
SunOS User’s Guide: Getting Started and SunOS User’s Guide: Customizing 
Your Environment for more information, and check with your system administra- 
tor to be sure. 



Can’t Remember Password If you forget your password, you cannot log in. You must ask your system 

administrator to change your password to something that is easy for you to 
remember. Once you can log in, you may want to change your password again 
so that it is known only to you. In general, long sequences of numbers, punctua- 
tion marks and other special characters are hard to remember, whereas words that 
evoke some meaning special only to you are easier to remember. 



Terminal Control Characters 
in Password 



Although you can use any character in your password, characters that can be 
interpreted as signals by the terminal such as 1 Ctrl-C 1 . [ Ctrl-Z 1 . 1 Ctrl-U 1 . 

[ Ctrl-S ] . ( Esc 1 . ( Tab ) . and in some cases QT) and RaT) should be avoided. The ter- 



minal may interpret these as signals rather than as text characters, and this would 
preclude you from typing in the password correctly. 



Capitals in the Username If you type your username in all capitals when you log in, the system will behave 

as if the terminal were uppercase only. All letters will be displayed in uppercase. 
To avoid this, leave capital letters out of your username when you log in. 




7 
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Misspelled Username or 
Mistyped Password 



No Home Directory 



No Shell 



Error Messages at Login 



2.2. Can’t Log Out 



Not Login Shell 



Stopped Jobs 



If you see the message 

Login incorrect 

try again. You may have miskeyed something. If on the third try you still aren’t 
logged in, see your system administrator. 

If you see the message 

No Directory! Logging in with home=/ 

This means that there is no directory set up for your use on the system. If this 
happens when you log in to another machine on the network, it may not matter. 
But if this happens when you log in to your own system, then you need to contact 
your system administrator to have him or her set up a home directory for you. 

If you see the message 
No shell 

then an error was made when you account was set up. Consult your system 
administrator. 

If you see an error message whenever you log in, there is probably an error in 
your .login file. If you see an error message whenever you start a new 
shelltoolor cmdtool window, then there is probably an error in your 
. c shr c file. Since these files contain commands like those that you can type in, 
they are not too difficult to correct. Refer to SunOS User’s Guide: Customizing 
Your Environment for more information about these files. 

When you use the window system on your workstation, you are logged in as long 
as SunView is running — even if you quit from every window in the display. To 
log out, you must exit SunView first . 5 

If the message 

Not login shell 

appears when you attempt to log out, you can use the exit command to kill the 
current shell, shelltool, or cmdtool. 

If the system responds with the message 
There are stopped jobs. 

then use the jobs command to see which commands are waiting. If you don’t 
care about any of them, a second command to log out will have the desired 
effect, and will terminate the stopped jobs as well. Refer to SunOS User’s 
Guide: Doing More for more information about jobs, stopped jobs, and job con- 
trol in the C shell. 



5 Logging out is one way to secure your workstation against unauthorized use. Another is to use the ‘Lock 
Screen’ item in the SunView menu. For more on security, see SunOS User’s Guide: Doing More. 
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2.3. Can’t Change When you use pas swd to change your password, you must enter the old pass- 

Password word correctly, or it will reply with 

Sorry . 

and your password will remain the same. 

If you use the su command to assume another user’s identity , 6 you cannot 
change that user’s password. Nor can another user change your password after 
gaining access with su. 

Network Access: Your NIS The NIS maintains a separate list of user accounts and passwords for everyone 

Password with access to the network. When you log in to another machine and are 

prompted for a password, it is asking you for your NIS password (which may be 
different than that on your current machine). 

To change your NIS password, use the command yppasswd. This command 
works just like pas swd. As you are prompted to do so, type in your old NIS 
password, your new password, and then confirm the new password. If you don’t 
know your NIS password, the system administrator for your network can issue 
you a new one. 



6 See SunOS User’s Guide: Doing More for more information. 
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Problems Running Commands 



Because there are error messages specific to every command, attempting to 
describe each and every one would only obscure those that are more general in 
scope. In this chapter we describe error messages that may come up when using 
just about any command. The next chapter describes those issued by selected 
commands that are used most often. Appendix A lists error messages that can 
arise when using the network to gain access to other machines. 



3.1. Problems With 

Command Line Syntax 



f — 




> 




. arg count 




v 




> 



You specified either too many, or too few, arguments for the command. An 
argument follows a command and modifies it; it can be an option to that 
command, like Is -F, or a file that the command works on, like cat 
namelist, or so on. Many commands that require arguments will display 
the proper command syntax when just the command (no arguments) is typed 
in. See also Too few argument s and Too many arguments. 



r 




Arg list too long 




l 


J 



Your command substitution 7 (or filename wildcard) expanded to form a 
command line of that is too long. This can happen when you use the cat 
command within backquote marks 0 ) or when you use * in a directory con- 
taining an extraordinary number of files. 



r 




Broken pipe 




l 


J 



The command that was receiving data from a pipe terminated before the 
command sending data finished. This usually means that the second or sub- 
sequent command encountered an error and died. For example, this can hap- 
pen when piping output through more, if you quit more before the other 



7 See SunOS User’s Guide: Getting Started and SunOS User's Guide: Doing More for more information. 




sun 
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command is done. You may have to look up commands in the pipeline in 
the SunOS Reference Manual to figure out what went wrong. 



/ 


-\ 


exec failed: wrong binary format 

V 


> 



You’re attempting to run software that will not run on the machine you’re 
using. This is likely to occur when you have copied a program from another 
user running a different kind of machine, or if you run software that is 
specific to a particular release of SunOS. Often, you can replace the pro- 
gram with a copy meant for your machine. 

If you have the source code for the program giving you this message, you 
may be able to recompile it on your own machine to make it work. 



r 




File exists 




V 


J 



The command attempted to overwrite an existing file. Move the existing file 
to a new name with mv or remove it with rm, and run the command again. 



s 

File name too long 


\ 


v 


J 



Your filename expansion string somehow expanded to a pathname with a 
component (directory-name or filename portion) exceeding 255 characters, 
or to a pathname that exceeded 1023 characters. Try specifying the path- 
name explicitly. 



r 


'v 


File not found 




V 


J 



The file you attempted to look up or get access to is not in the directory. 
Refer to the discussion of f ind in SunOS User’s Guide: Doing More for 
information on how to look up a file when you don’t know the directory it is 
in. 



^ 

File too large 

V / 



o 

The size of a file exceeded the maximum (about 10 bytes). If you see this 
message, consult your system administrator immediately. 
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f 

Is a directory 






J 



You attempted to read or write on a directory as if it were a regular file. 
(Can happen to anyone). 



T 


. No match 


\ 


l 




J 



The filename substitution pattern you gave did not match any files. 



r 




No such file or directory 




V 


J 



This error occurs when a named file does not exist or when one of the 
directory-names in a pathname does not exist. 



r 




Not a directory 




v 


J 



You supplied the name of a file to a command that expects a directory, such 
as cd. 



r 




Not owner 




V 


J 



You tried to access or change permissions of a file that you don’t own, you 
attempted to kill a process that you don’t own, or you attempted to run a 
command that can only be run by the superuser (root). Refer to SunOS 
User’s Guide: Getting Started and SunOS User’s Guide: Doing More for 
more information. 



f 


l% \ 


Out of memory 




v 


J 



There are too many processes taking up memory on your Workstation. If the 
system’s performance is still good, then a good many processes may be idle 
and unnecessary. Use ps and kill to terminate idle processes that you 
own. Refer to SunOS User’s Guide: Getting Started for more information 
about processes. 





Permission denied 





You attempted to either read, write, or execute a file for which you lack the 
proper permission. Refer to SunOS User’ s Guide: Getting Started for more 



©sun 
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information about files and permissions. 





. Stale NFS file handle 








) 



The rug got pulled out from under the file you were using. The file is in a 
remote-mounted file system that got unmounted by its host system (perhaps 
by a crash of that host), or someone on another machine removed it, or 
moved a new version into it while your command was still running. Do an 
Is on the directory to see if the file is still there. If the file is there and its 
contents are what you expect, then rerun the command. 

If the file is missing or its contents are unfamiliar, then you may need to get 
the version you need restored from backup. Files that are accessible from 
more than one machine may need to be protected using see s to prevent col- 
lisions like this. Refer to SunOS User’s Guide : Doing More for more infor- 
mation about secs. 

If no files are listed, have the system administrator remount the filesystem on 
the remote host, and run the command again. 



— 


\ 


Too many arguments 




v 


J 



The command you used expected fewer arguments. For instance, you can 
cd to only one directory. 



— 


s 


Too few arguments 

\ 


j 



The command you used expected more arguments. For instance, mv 
requires a minimum of two arguments: a filename and its new name. 



r 

Too many levels of symbolic links . 


\ 


v 


) 



A pathname lookup involved more than 8 symbolic links. To reduce the 
number of symbolic links needed to resolve the pathname, use Is -1 to 
look up the filename pointed to by the symbolic link. Then supply that 
name to Is -1, and so on until you reach the file or directory. 



r 





Too many links 




V 


J 



You can have only 32767 hard links to the same file. Actually, if you see 
this message it could indicate that someone mistakenly made all those links. 
It is a good idea to report this to your system administrator so that the prob- 
lem can be corrected. 



©sun 

\r microsystems 
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t 





Usage: ... 




v 


J 



You typed in the command incorrectly, and it responded with a syntax 
diagram as a brief reminder. If the syntax summary is not clear to you, or if 
you need to know the full range of options open to you, check the SunOS 
Reference Manual. 



c 




A 


. . 


. Unknown option 




1 




J 



The option you specified is not valid for the command you typed. See Too 
many arguments above. 



— 


>1 


Unknown error 




v 


J 



The system encountered something very strange. Contact your system 
administrator immediately. Do not attempt to correct this yourself. Your 
system administrator needs to see the exact sequence of events leading up to 
this error message. 



3.2. Unforeseen Conditions 



r 


\ 


Disc quota exceeded. 




( 


/ 



You attempted to write on a file, create a new file, or create a new directory 
that would exceed your disc quota. 



r 




Read-only file system 




V 


J 



You attempted to write on a file or in a directory within a filesystem that is 
mounted read-only. 



r 


\ 


... write failed, file system is full 




v 


J 



r 


\ 


File system full 




v 


J 



There is no more room in the named filesystem. This message can come up 
when there are extremely large print jobs in the printer queue and you are 
running programs that use temporary files (such as vi) on a diskless Works- 
tation. Both the printer queue and the /tmp directory may be in the same 
filesystem, which gets filled up with data for the printer. The solution is 
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either to remove one or more print jobs or wait until those print jobs finish. 

If the printer queue is not the problem, the df and du commands can be 
used to look at a system’s file space. 



/ 


\ 


segmentation fault 




core dumped 




V 


j 



f 


'I 


Bus error 




core dumped 




V 


J 



The program failed to protect itself against an unexpected occurrence or 
internal error. The message core dumped means that the system has 
copied an image of the process into a file called core, in the current direc- 
tory, for use in debugging. If you don’t plan to attempt debugging, you 
should remove core, as it is often a large file. 

If the program can’t be debugged, the only recourse is to try rectifying the 
input, option, or condition that caused the problem — if such can be deter- 
mined. 

Sometimes segmentation faults are the result of poor memory management 
by programs. 
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Problems With Selected Commands 



To interpret an error message produced by a specific command not contained in 
this list, refer to that command in the SunOS Reference Manual. 



r 


\ 


cat: No such file or directory 




v 





Either you are in the wrong directory, the file does not exist, or you do not 
have permission to read it. 



r 


-\ 


cat: input filename is output 




l 


J 



You cannot cat the contents of filename to itself. Unfortunately, by the 
time you see this error message, the shell will have emptied out the file in 
preparation for writing to it. You can prevent this by having noclobber 
set, which prevents files from being written over, no clobber will give 
you the error message File exists. For more on no clobber, see 
Chapter 1. 



r 




pathname : bad directory 




V 


J 



You do not have permission to change to pathname. 



r 

chmod: can't access filename 


> 


V 


J 



You attempted to change permissions of a file or directory that does not 
exist. You may be in the wrong directory. 
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cp 



date 



df 



r 

chmod: can't change filename 


N 


V 


/ 



You attempted to change permissions on a file you don’t own. 



/ 


■N 


chmod: invalid mode 




V 


J 



You specified the new permissions incorrectly. Perhaps you typed filename 
ahead of the permissions argument. 



/ 


■n 


cp: cannot open filename 




V 


J 



The file specified by filename either doesn’t exist, or it does not have read 
permission. 



r 

cp: cannot copy file to itself. 




v 


J 



The two filename arguments to cp must represent different filenames. 



r 

cp: cannot create filename 


N 


l 


j 



This usually indicates that you are in a directory which you don’t own, or 
you are trying to create a file in a directory for which you don’t have write 
permission. 



f 





date: no permission 




v 


J 



You must be the superuser (root) in order to set the date. 



( 


— 


cannot open device 




V 


J 



The filesystem or device you specified is not accessible. 
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dif f 



grep 



kill 




Something is wrong in the file system. Notify your system administrator 
and do not try to fix this yourself. 




Use the -h option when running dif f on huge files. 




You supplied an option that grep does not recognize. Refer to grep in the 
SunOS Reference Manual for a list of valid options. 




The search pattern, or regular expression, on the command line is too long 
for grep to handle. You must shorten the expression, perhaps by perform- 
ing the search in stages using several grep commands within a pipeline. 




Either filename does not exist or you do not have read permission for it. 




Either the process does not exist or has terminated. 
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In 



Is 




You are attempting to kill a process that someone else started. Many 
automatic processes are actually owned by daemons. Often you can r lo- 
gin in as root and kill processes you don’t own. 




You attempted to create a hard link to a file in another filesystem. You may 
create a symbolic link instead. 




Use the - s option to make a symbolic link to a directory. 




Some options of the Is command sort the filenames before displaying them. 
This message occurs when there is not enough memory available to perform 
the sort. Use ps and kill to eliminate extraneous (idle) processes. See 
SunOS User’ s Guide: Getting Started for more information. 
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make 



ink dir 



man 



mount and 



umount 



Don't know how to make target 

V j 


You asked make to process a target not contained in your makefile. 


r \ 

mkdir: cannot access directory 
k j 


directory does not exist or you don’t have read access to its parent. This 
may come up should you try to create a subdirectory before its parent direc- 
tory is created. This also appears when the parent directory does not have 
write access. 


r "\ 

mkdir: cannot make directory dir 


The directory specified by dir already exists. 


r 

No entry for item . . . 


There is no entry for the item you asked for in the online man pages or in the 
section you specified. 


Block device required 

V J 


You tried to mount something other than a filesystem. 


r 

Mount device busy 

^ . .. > 


You attempted to mount filesystem that is already mounted or to dismount a 
device on which there is a file in use. 


r 

You must be root to use mount 


You must be logged in as root (the superuser ) to use these commands. 8 
If you know the root password for your workstation, use su - f to “become 



root” quickly and mn the command. Commands in Section 8 of the SunOS 
Reference Manual are typically run by root. 



mount with no arguments displays the filesystems you currently have mounted. You do not have to be 
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Too many levels of remote in path. 


> 


v 


J 



You attempted to mount a remote filesystem within another remote-mounted 
filesystem. 



mv 



can't mv directories across file systems 



Use cp -r to copy the directory, its files, and any subdirectories (with their 
files) to the new location. Then use rm -r to remove directory and its files 
from the old location. 



r 


\ 


mv: directory rename only 




V 


J 



This message appears if you type a command of the form: 

mv filename olddir newdir 

You can either move a list of filenames to a new directory, or move a single 
directory to a new name, but not both in the same command line. 







mv: cannot unlink filename 




l 


J 



Usually arises because you are not the owner of the directory containing 
filename . 



mv: cannot move a directory into itself 

v y 



The source and destination directory names must be different. 



pwd 



r 




pwd: cannot open . . 




V 


) 



The parent directory has somehow become read protected, and the pwd 
command cannot read it to determine the pathname of the current directory. 
This can happen when you have more than one cmdtool or shelltool 
window open and, from within another window, you change the permissions 
of any directory in the pathname of the current directory. The C shell com- 
mand dirs may serve instead of pwd. 

root to use mount this way. 
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rm -r and rmdir 



Note: 



rm -r will silently remove a full directory just as long as 
□ You own it, and 



□ noclobber is not set. 



r 

Directory not empty. 


> 


v 





troff and nroff 



There are still files in the directory. Use Is -a to see them all. 



f 


> 


filename not removed 




v 


J 



Either you lack write permission for the directory that contains the file or 
you did not answer with a y when asked for confirmation to remove the file. 



— 


\ 


Core limit reached. 




V 


J 


Refer to Out of memory in Chapter 3. 


r 


A 


Segmentation fault. 




core dumped. 




V 


J 



A closing macro was missing. Use checknr to obtain a list of possible for- 
matting errors. The message core dumped indicates that the system 
copied an image of the process where it left off for further diagnosis, if 
needed. 



— 


N 


Typesetter busy. 




1 


J 



Either troff was not properly installed on your system or network, your 
system uses a local version, or the phototypesetter is temporarily unavail- 
able. Consult your system administrator to find out which is the case. 
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Problems Editing Text Files With vi 



5.1. Operating Problems The problems described in this section require you to perform specific tasks in 

order to avoid losing text or changes made since the file was last written. 

Deleted Wrong Text or Need When you have made several deletions, such as when you use dd successively to 

Previously Deleted Text delete lines, you may find that you want some of the deleted text back again. If 

you want the most recently removed line, you can use u (undo) to restore it. But 
suppose you want to undo the third-to-the-last deletion? 

When you delete text (of a line or more), vi saves that text in a buffer. There are 
9 numbered buffers that contain up to the ninth most recent deletion. To recover 
the nth most recent deletion, use the p command as follows: 

"np 



Hint: If you don’t which buffer (or register) contains the text you want, start by 
typing 

M ip 

If that’s not the buffer you want, type u (for undo) and a dot (.) to repeat. This 
will show you buffer 2. Repeat this procedure until you find your text or until 
you see the message, Nothing in register n. 

When you delete a word or portion of a line, this text is not saved in a buffer. If 
you want to recover it, say, after adding some more text (in which case u won’t 
work) use p (put). 

Nested Editing Sessions One common error in using vi is to run multiple copies of vi simultaneously on 

the same file. It’s very easy to lose a lot of editing work this way. 

You lose work because each time you run vi on a file, you edit a completely 
separate copy of the file. When you’re done editing, you make that copy’s 
changes permanent by writing it out to a hard disk. If you do simultaneous edits 
on the same file, then each time you end vi you’ll write over any changes you 
might have made in other copies. 

There are two common ways of accidentally running vi more than once on the 
same file. One way is if you are editing a file and you use 1 Ctrl-Z ) to temporarily 
stop vi and put it in the background, and then type vi to go back to editing the 
file. If you do escape vi with [ Ctrl-Z 1 . do not go back into vi by typing vi; 
rather, use the % command, as explained in SunOS User’s Guide: Getting Started 
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This puts you back into your original editing session. 

The other way is use the : ! shell escape, which allows you to run SunOS com- 
mands from within vi. One such command that you can run is, oddly enough, 
vi. It’s okay to use : ! vi filename only if you edit a different file. Do not 
attempt to use this shell escape to edit the file you’re already editing. 

Try this on a test file to see how it can happen: 

CAUTION Do not run this test on a file containing information of any value. 



Make a copy of a file and call it t e st . Run vi on the file. 



/ — — : — — — — 


• . ' V 


verms % cp memo test 




venus % vi test 




(vi screen comes up) 




■■■■-■ ^ 


/ 



Now, use : ! to run vi again. When the new vi screen comes up, delete its con- 
tents with dG, then go to the first vi session with : wq. 



f 




:! vi test 




(vi screen comes up) 




dG 




(text is deleted) 




:wq;. ■ 




(previous text comes up) 




v 


- : • J 



At this point you can check to see that the written-out version of the file has less 
text by running the command : ! more test 



r~ : — 


1 .;:,:,! : ' " >> 


: ? more test 




(Hit [ Return ) to continue) 




V ■ : ■ : : : • ■ : ■ : ^ 


J 



After typing [ Return 1 . write and quit, then run more test from the C shell. Lo 
and behold, the contents are back! But what would have happened if you had 
added text rather than deleting it in the “inner” vi session? 



If you accidentally do find yourself doing multiple edits of a single file, exit from 
that session with : q 1 . 

Hint: If you want to have more than one copy of the file open in different win- 
dows, use vi to open it one, and view in the others, view is just like vi, 
except that it does not let you save any changes to the file. 



Recovered Wrong Version If you type in the -r option, and the file you are editing was once preserved dur- 

ing a crash (but not yet recovered), vi will recover this older and probably out- 
dated version. If the date displayed for the file does not correspond to the most 
recent crash, do not write the file and do not edit it. Rather, check the file very 
carefully to see if it is up to date. If it is not, then use : q ! to exit immediately 
from vi. Or, if in doubt, use 

:w filename . REC 

to save the recovered version. You can then exit vi and run dif f to compare 
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Can’t Write Changes 



Ran Out of Disk Space 



the two versions of the file. 

If you have already typed : w, you may have to have the system administrator 
recover the more recent version from backup tape. 

When you edit a file for which you don’t have write permission, you can still 
make changes to the temporary copy vi uses. If you don’t own the file, you can 
write out a modified copy by supplying a filename to the : w ! command: 

:w! newfile 

If you have write permission on the directory, you can exit vi and use mv to 
replace the existing version of the file with your modified version. 

If you own the file, you can force the changes to be written out, even though vi 
complains. To force the changes to be written, use the command 

: ! chmod +w % 

to give yourself write permission on the file. The percent sign is a symbol that 
stands for the name of the file currently being edited. Then use 

: w ! 

to force the changes to be written. Of course, if you don’t own the file, this won’t 
work. 



If, when you attempt to write a file, you get a message that the file system is full, 
then you will need to find another filesystem with more space. Use the command 

: ! df 

to see which filesystems have space available and pick a directory in one of them. 
To write the contents onto a new file in this other directory, use the command 

:w! pathname 

Next, notify your system administrator about the full disk, so that she or he can 
move some of the files to another disk or remove them to tape. 

If you get a message indicating that your disk quota has been reached, you may 
either have to forgo writing your changes or go searching for files to remove 
instead. (You can use ( Ctrl-Z 1 to suspend vi while you hunt for files to remove. 
Use % to resume vi where you left off.) 

If the system drops from vi into open mode and indicates a filesystem is full, 
this means that the disk containing vi’s temporary files filled up. Use the com- 
mand 

! Is /var/tmp 

to see if there are files that you can remove. If you have queued up large print 
jobs, you may have to remove some of them or wait until they’ve printed, to 
regain disk space for vi. 

Another directory to look in is /var /adm. It contains a number of files that 
contain records of your activities on the machine, such as the file messages, 
which keeps all the messages your system sends you. These files should be 
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cleared out from time to time. (You must be the superuser, root, to do this; see 
SunOS User’s Guide: Doing More for information on becoming superuser.) If 
you are sure that you don’t need the file, use vi to remove its contents. 

vi Comes Up as ex You typed an interrupt signal before vi could draw the screen. Use the com- 

mand vi to begin (or resume) full-screen editing. 

5.2. vi Error Messages Should a problem arise during an editing session, vi may display one of the 

messages listed below. 



Problems Starting Up 



f 




Bad termcap entry 




Termcap entry too long 




terminal : Unknown terminal type 




Block device required 




k 


J 



r 


V 


Not a typewriter 




V 


/ 



vi could not figure out how to work with the terminal you are using. See 
you system administrator to correct this problem. 







Block special file 




Character special file 




Directory 




Executable 




Non-ascii file 




file non-ASCII 




l 


J 



f 


a 


Bad file number 




l 


J 



The file you attempted to edit was not a regular text file. 



Problems With File Recovery 





Can't fork to execute recovery 
Can't make pipe for recovery 

V > 





[Warning - file is incomplete] 

s. J 



vi was unable to recover all or part of a file preserved after a crash. See 
your system administrator. You may have to recover an earlier version of 
the file from backup tapes. 
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Problems Writing a File 




When you specify a file to write with : w filename, vi checks to see if a file 
by that name already exists. If so, you see one of these messages. Use : w ! 
filename to overwrite the file. 




Either you are running view or you lack write permission for the file. In 
either case, see under Can’t Write Changes, above. 





Revision A, of 27 March 1990 









A 



Problems With Network Access 



The following messages indicate a problem accessing a remote system over the 
network. 





NFS server name not responding still trying 
NFS server name okay 

S / 



This is the network equivalent of “Don’t touch that dial; we are experiencing 
technical difficulties.’’ Your machine is having trouble connecting with the 
server name ; this message often shows up when the remote server is very 
busy and your machine has to wait for service. Wait a bit to see if the con- 
nection is eventually made or regained. If the message continues, the remote 
machine may have “died.’’ 



Connection refused. 



The remote machine is unavailable at present. 



^ 

Connection timed out. 

v / 



The remote machine failed to respond within the required time limit. Either 
it is too busy to accept new connections or it is restarting ( rebooting ) after a 
crash. 



f 

Network dropped connection on reset. 




V 


> 



The host you were connected to crashed and rebooted, dropping the network 
connection to your system. 
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A 

access to the network, 31 

... arg count, 11 

Arg list too long, 11 

argument too long, 19 

asking for help, information needed, 3 

B 

Bad file number, 28 
bad free block, 19 
bad free count, 19 
Bad termcap entry, 28 
Block device required, 21, 28 
Block special file, 28 
Broken pipe, 11 
Bus error, 16 

c 

Can't fork to execute recovery, 28 
can’t log in, 7 thru 9 

Can't make pipe for recovery, 28 

can't mv directories across file systems, 22 

can't open filename, 19 

cannot open device, 18 

cat command, 17 

cat: input filename is output, 17 
cat: No such file or directory, 17 
cd command, 17 
changing NIS password, 9 
Character special file, 28 
chmod command, 17 

chmod: can't access filename, 17 
chmod: can't change filename, IS 
chmod: invalid mode, 18 
command 

alias cp 'cp -i' for preventing accidental deletion, 4 

alias mv 'mv -i' for preventing accidental deletion, 4 

alias rm 'rm -i' for preventing accidental deletion, 4 

cat, 17 

cd, 17 

chmod, 17 

cp, 18 

date, 18 

df, 16, 18 

dif f, 19 



command, continued 
du, 16 

generic error messages, 1 1 thru 16 

grep, 19 

kill, 19 

In, 20 

Is, 20 

make, 21 

man, 21 

mkdir, 21 

mount, 21 

mv, 22 

nroff , 23 

pwd, 22 

reset, 6 

rm, 23 

rmdir, 23 

set noclobber for preventing accidental deletion, 4, 17 
sync, 4 
troff, 23 
umount, 21 

Command not found., 1 
common causes 

mistyped command or argument, 2 
wrong directory, 2 
wrong user’s account, 2 
confused terminal, 6 
confused window, 6 
Connection refused., 31 
Connection timed out., 31 
core dumped, 16 
core dumped., 23 
Core limit reached., 23 
cp command, 18 

cp: cannot copy file to itself., 18 
cp: cannot create filename, 18 
cp: cannot open filename, 18 
crash, restarting the system, 5 
Cross-device link, 20 

D 

data loss and v±,25thru2S 
date command, 18 
deleted data or files, 3 
deleted text and vi, 25 
df command, 18 
dif f command, 19 
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Directory, 28 

Directory not empty., 23 

Disc quota exceeded., 15 

discovering a problem, steps to take, 3 

disk out of space and vi, 27 

disk quota and vi, 27 

... does not exist, 20 

Don't know how to make target, 21 

E 

editing sessions, nested, 25 
editing, can’t write out changes, 27 
ex and vi, 28 

exec failed: wrong binary format, 12 

Executable, 28 
[Existing file ] , 29 

F 

file 

lost or deleted data, 3 
preventing accidental deletion, 3 
recovering editor files after system shutdown, 5 
File exists, 12, 17, 20, 29 

File exists - use w! file to overwrite, 29 

File is read only, 29 

File name too long, 12 

file non-ASCII, 28 

File not found, 12 

File not found., 1 

File system full, 15 

File too large, 12 

filename not removed, 23 

Files too big, try -h, 19 

forcing data to disk, 4 

full disk and vi,27 

G 

getting help, information needed, 3 
grep command, 19 

H 

hung terminal, 6 
hung window, 6 

I 

initial steps for any problem, 3 
Isa directory, 13 

J 

job control and vi, 25 

K 

kill command, 19 

L 

Line Feed key, 6 
In command, 20 

In: name is a directory, 20 



logging in over the network, 9 
login 

problems, 7 thru 9 
logout problems, 7 thru 9 
lost data or files, 3 
1 s command, 20 

M 

make command, 21 
man command, 21 
messages file, 28 
mkdir command, 21 

mkdir: cannot access directory, 21 
mkdir: cannot make directory dir, 21 
monitor, 5 

mount command, 21 
Mount device busy, 21 
mv command, 22 

mv: cannot move a directory into itself, 22 
mv: cannot unlink filename, 22 
mv: directory rename only, 22 

N 

nested editing sessions, 25 
network access problems, 31 

Network dropped connection on reset., 31 
network password, 9 

NFS server name not responding still trying, 
31 

NFS server name okay, 31 
No entry for item ...,21 
No match, 13 

No such file or directory, 13 

No such process, 19 

noclobber, 4 

noclobber command, 17 

Non-ascii file, 28 

Not a directory, 13 

Not a typewriter, 28 

Not owner, 13 

nrof f program, 23 

o 

Out of memory, 13, 20 

P 

panic: condition, 5 

password problems, 7 thru 9 

pathname : bad directory, 17 

Permission denied, 1, 13, 29 

permissions, and writing changes from within vi, 27 

pid: not owner, 20 

preventing accidental deletion of files, 3 

pwd command, 22 

pwd : cannot open . . , 22 
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Q 

quotas and vi, 27 

R 

RE error, 19 
[Read only], 29 
Read-only file system, 15 
recovered wrong version with vi -r, 26 
recovering editor files after system shutdown, 5 
removed files by mistake, 3 
restarting system after a crash, 5 
rm command, 23 
rmdir command, 23 

s 

segmentation fault, 16 
Segmentation fault., 23 
Stale NFS file handle, 14 
system crash, 5 
system shutdown, 4 

T 

Termcap entry too long, 28 

terminal : Unknown terminal type, 28 

terminal, unresponsive, 6 

Too few arguments, 11, 14 

Too many arguments, 11, 14, 15 

too many files, 20 

Too many levels of remote in path., 22 
Too many levels of symbolic links., 14 
Too many links, 14 
trof f program, 23 
Typesetter busy., 23 



u 

umount command, 21 
Unknown error, 15 
unknown flag, 19 
Unknown option, 15 
. . . unreadable, 20 
unresponsive terminal, 6 
unresponsive window, 6 
Usage : . . ., 15 
/usr/var/adm, 28 

/usr/var/adm/messages file, see messages file 

V 

vi editor 

alternating with C shell using job control, 25 

and a full disk, 27 

and data loss, 25 thru 28 

and deleted text, 25 

and disk quota, 27 

and view, 26 

can’t write out changes, 27 

comes up as ex, 28 

nested sessions, 25 

problems starting up, 28 

problems with file recovery, 28 
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problems with writing a file, 29 
recovered wrong version of file with -r, 26 
view, 26 



w 

[Warning - file is incomplete] , 28 
window, unresponsive, 6 
worst cases, 3 

deleted data or files, 3 

write failed, file system is full, 15 

Y 

You must be root to use mount, 21 
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